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Conventions pf ihli Memo 

Most numbers written In arable numerals are octal while all 
those written out In enpllsh arr? decimal* 

Underlining a character and tnmedlMely nrecedlnr It with a 
vortical bar indicates the character produced by holding down the 
control key while striking that character except In the case of 
II which reoresents an ALT MOPE, Characters not Indiratahle with 
the character set used In this memo or control of such a 
character arc described between anrle brackets. The strlnr fro^ 
the onen to the close anrle bracket should be considered as ore 
character which may be controlled by underlining and preceding 
with a vert Icle bar. 

Lower case letters In a conrnand string usually Indicate a 
oosslbly optional variable while capital letters or special 
characters are constant* 

Mote the special conventions Involving t In the MACDKP 
section. 
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Organization a£ PPP-5 Softer* 

MACDMP Is normally used to toad system and user machine 
language programs. If when one approaches the PDP-6 It Is not In 
MACDMP (which Is usually displaying a file directory) one should 
first try startlnp at location 177ii00 which is MACDMP's starting 
address. If this falls he sure a system tape Is mounted of drive 
number one and try reading In at location (see appendix). If 

that loses try locat ions 1 and 2« If still unsuccessful try 

placinr a paper tape of MACDMP In the paper tape reader, turning 
it on, and startinp at location 20 (see appendix). If all else 
fails you can conclude that most of memory Is clobbered and load 
a paper tape of MACDMP according to the Instructions on the 
inside of the left door of the first bay of the PDP-6 to the left 
of the console. 

When f Inal ly In MACDMP one may load and start various 
systems programs such as LISP or TECO or one may load a fairly 
arbitrary machine lanpuape propram with or without DDT* Most 

systems programs provide a way to pet hack to MACDMP and are 
unl ifcely to die randomly. However, a machine lan^uape prop ram 
belnp dehupped should normal 1 y he loaded wl th DPT so that 
locations In the program can be examined and chanped symbol Icly 
and so that more of the machire conditions (such as AC's) nay be 
saved on a dump by MACDMP If DDT Is first started (at location 
1 7 'i > and control transfered to MACDMP with the Ufccrmand* 

In normal use a system tare Is mounted on drive one with 
such programs as DDT, TFCO, MITAS, STirK, LISP, etc. or it. The 
other three drives are free for users' tapes or such tapes as the 
library and console scratch. 
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MACPHP (replacing memo MAC-M-248 or AI-R2) 

HACDMP Is a program normally resident at the top of that 
Portion of the PDP-6 memory helnp used (usually G5K) and whose 
main purpose Is to load programs from and dump programs on MAC 
format (see memo MAC-M-2*i9) DFf tapes. In general MACDMP does 
not dump locations containing zero or locations to 37 or any 
part of Itself. It does not load Into locations to 37 or 
Itself nor does It set these locat Ions to zero when It "clears 
core". All loadinr commands set locat Ion Uft to zero. 

When aulescent It also displays th^ file directory of Its 
current taoe on the 3<i0 display* 

A bell will he typed out for any error MACDMP detects such 
as the fol lowlnrt checksum error on reading, file not In 

directory for read, not enouph room on tape or In file directory 
for dump, tape write locked for dump, more than one unit of the 
selected number, disagreement on verify, no symbols In file for 
Til. 

In the list of commands below t represents a carrlare return 
but an |£ will also be accented If the Immediately proceeding 
file name Is null or begins with two letters. Before Its 

terminal character a command may be cancelled hy typing a <PUB 
OUT>. If orly one file name Is flvcn It will be assumed to be 
the second with fi as the first. If no file names are R*ven then 
C will be used as both tt^e first and second file name. Aiming 

the 31*0 display's Ilpht pen at a file Is eculvalent to typing Its 
file names followed by a carriage return, 

n|£ Sets the current tape to tape n If n Is In the Interval 

to 7. Tape zero Is a pseudo-DFC tape which Is both 
small and rapid and Is In reality the hottom 1 6K of the 
262K Fabrltek memory whir* Is normally masked by the 16K 
of fast memory. If n Is greater than 7 the currert 
startler address Is set to n, 

Gil Transfer control to the current starting address. 

fnl fn24 Clear core, load rrnrram fnl fn?, and po to Its 
starting address. 

Lllfnl fn2£ Clear core, load, set startlnr address, but stay In 
MACDMP, 

M|;*f nl fn2£ Loe;' (Mer^e) and set start I np address staying In 
MA COM P. 

I l£fnl fn2i Verify core aralnst program fnl fn2. 

Tlifnl fn24 This command assumes that DDT has been loaded and 

that fnl fn2 Is a file with symbols. It clears core 

below DPT, loads fnl fn2, adds she symbols for fnl fn2 
to DOT's symbol table and *oes to DOT. 
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N|£fnl fn2£ The same as Tli but does not clear core below DPT. 

D|£fnl fn2t Dumps the contents of core on the current tape as a 
flte called fnl fn2 with the current starting address 
and write out the updated file directory of the current 
tape. A previous file of that name will be deleted. 

Kljfnl fn2« Eliminate the file fnl fn2 from the file directory 
of the current tape. Does npt write out Its file 

directory. 

D|£n|i Dump out the current file directory on tape n, 

Hinli Verify the current file directory against that for tape 
n. 
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Chang es to TFfp ( supplement I nr memo MAOM-250 or A I -81) 
The followlnf new commands have been Introduced: 

IJ£ Turns on line printer output and when first used causes 

one form feed to be sent to the line printer. 

I£ Turns off line printer output. 

I£ Has the value of the setting of the data switches, 

\Q_ Generates, on whatever output devices are currently 

selected, a listing of the file last ER'd or EF'd. Two 
passes ^r^ made over the file during the first of which 
a symbol table Is made up with, for each symbol 
encountered, the pare and 1 Ine number the symbol I s 

defined, declared a variable, or defined a macro on, if 
any, and whether the symbol Is declared global. On the 

second pass two title pafes art^ printed with the file 

names In larre letters and the tape label In small 
letters (see the ES command helovOr These are followed 
by the file with pa**e numbering and three columns of 

numbers to the left. The first of these Is the line 
number while the second and third are the pape and line 

number of the definition of the last symbol appearing on 
that line ouside of parentheses. Finally a symbol table 
Is printed with all the encountered symbol s in 
alphabetic order followed hy the pare and line number of 

their definition. The pare and line number are normally 
separated by a space which Is replaced by an asterisk If 

no reference to the symbol Is not iced. If no definition 

Is noticed for a global symbol the word "undef " t?1 1 1 
appear In place of pare and line numbers. A single 

letter may also appear between the symbol and Its 

defining location with the fol lowinp meaning; M 

signifying a macro, V slpnlfyinp; a variable, or G 
sf^nlfylnp a global symbol. 

nlfi Causes |fl to make n listings repeating only pass two If 

n Is greater that 2ero. If n is less than or eoual to 
zero then the "file name" fol low I np the 1£ and 
terminated by an li is hi? printed and no other 
operat ions preformed by the co«fnand, 

EP Takes a file name arjrumont, EP's that file and then blf 

prints I ts name. 

Kup arrowy Has the value of the ASCII code for the Iirmediately 
fol lowing character. 

<open bracket> Push the value stored In the O-repister specified 
by the next character onto the O-reMster pushdown list. 
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<close bracket> Pop the most recently stored entry on the 
O-rerlster pushdown list Into the 0-rc^Ister spec! fled 
by the fol lowlnp character, 

<backslash> Without an arpument has the value of the numher 
which Is assumed to he Immediately to the rlpht of the 
pointer In the buffer and causes the pointer to be moved 

to the rlpht of this number. With one argument will 
Insert In the buffer at the pointer the drclnal print of 
Its argument. With two arruments will Insert In the 
buffer at the pointer the decimal print of Its second 
arrument possibly padded on the left w!th spaces so as 
to Insert at least as many characters as the value of 
Its f I rst arr unent ■ 

li, II Inside a macro II and |Y have the value of the two 
arpuments plven when the macro was called. If only one 
arpument was given, |£ Is zero and IX has the value of 
the argument jrlven. If no arpuments were plven both 12. 
and |Y are zero. 

nES Assign a three character label to tape n (optional 

argument, if none plven the current tape Is assumed). 
The three character name fol lows the ES cormand and Is 
terminated by a |£. This label Is Inserted If the tapes 
file directory but the directory Is not written out. 






nEM Causes a listlnp of the file directory of tape n 

(opt lonal erpument, I f none ptven the current tape Is 
assumed) to be inserted Into the buffer. 

I£ Takes an ortlonal strfnp arpument which. If given. Is 

passed on to MflCTMP with a carriage return added to the 
end of the strlnp. If dollar slpns arpear Ir the strlnp 
they will he replaced by IS's before beinr passed to 
MACCKP. 

Kleft arrowy I <close bracket> Used for Input-output vl? PIT to 
Ill's PPP-7~ Consul t a systems' programmer for more 

info mat Ion. 
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Special characters In search strings: 
|£ Matches any break character, 

|£ Takes the Immediately following character as an argument 

and will match anythlnr hut that character. Itilfi will 

match any non- break character* 

\Q_ Separates str Inrs in a search command and causes 

Independent searches, one for each strlrf, to occur. 

The strlnr which occurs earliest In the buffer Is the 
one which Is found. If the search Is performed with the 

colon modifier. Its value will be zero If It falls or 

minus n If the nt fi string Is the one found. 

Ifl Quotes the next character causing any special 

significance It mteht normally have to be Ignored. 

IX Matches any character. 



Other changes. 

On Input from a teletype the characters with the values 33 
and 17G are converted to 175. 

The Y command <*iay now be used to re*d part of a "page" 
longer than the buffer, also nY will read at most n characters. 

Numbers that are followed by a period will be considered 
octal , 

TECO's error comment of a cuestlon mark has now been 

supplemented by a variety of three letter codes some of which 
follow: 

2<I Second argument less than first. 

ION Illegal Q register name* 

NIB Not In buffer, 

SFL Search failed. 

UEC Unexpected end of cornnand* 

UMC Unmatched close. 

WKA Wronjr number of arguments. 
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Pa*e £ 



Changes 1q Ml PAS (supplementing memo MAC-M-279 or AI-90) 

New pseudo-instructions: 

ASCIZ The same as ASCII except that a word of zeros If forced 

after the strlnr If the number of characters Is a 
multiple of five. Thus the character strlnx always end 
In a zero character, 

.ASCII The same as ASCIZ except that If an I Is encountered In 
the string It will be assumed to be followed by a field 
whose value will be octal printed Into the string at 
that point* 



.TYPf Has a value determined by the status of the symhol that 

fol lows I t according to this table: 
pseudo-op or macro 
defined local symbol 
local undefined symbol 
local def I ned variable 
local undefined variable 
global defined variable 
global undefined variable 
global entry (defined In prop ram) 
global ex 1 1 {not defined In program) 
not in symbol table 



2 

3 

k 
5 

6 
7 

10 

i 1 ; 1 



.GLOBAL Takes a 1 1st of symbols as arguments and Is eculvalent 
to placing a " on an occurance of each- 



•LIBRO Takes a list of symbols as arruments and makes each 
"seen" and "reouested" as far as the loader Is, 
concerned. 



.GSSET 



.NSTGW 
.YSTGW 

,LNK0T 



Set the generated symhol counter to the value of the 
following expression. The next generated symbol will be 
of the form Gxxxxx where the number xxxxx Is the value 
of the counter plus ore. 



Print an error If any storare words are generated. 
Permit storage word generation. 

Punch out loader words to unllrk core In preparation for 
a load-time transfer to your propra™. 



. I STOP 
• STOP 



Stop the processing of the current I RP-class pseudo 
operat ion. 

Stop the current Iteration of the IRP-class pseudo 
operation or repeat and ta^e the next element of the IPP 

list. 
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• LOF Loader .OP wMch Is the sane as .OP except that It 

occurs at load tlr^e and has no value. Instead the 

values left In AC and AC*1 are placed Into the global 
symbols .LVAL1" ard .LVAL2 1 ' respectively. 

• TAG, .GO Used to control the flow of character hand Tin; irsfde 

macros and IRP's. .TAG Is a NOP when encountered e*cert 

that It causes the symbol fellmlnf It to be Irnored. 
.GO takes the syrrhol fnl lowing and begins from the start 

of the macro or IRP body a search for the character 

string ".TAG". Upon finding a .TAG It compares the 
symbol followlnr with the symbol after the .GO . If 

equal the macro scan pointer is left following the 
symbol after the ,T/>G . If not eoual It continues to 
scan the rest of the current nacro level for a match. 
If not found the macro processor Is popped up one level 
and the scan Is continued. This Is continued unt II 

either a matching symbol Is found or the top level Is 
reached, 

.FORMAT The manner In which Ml PAS Interprets fields Is 

determined by I ts format table. The entries In this, 

table consist of three twelve bit bytes per word. Each 
byte consists of two six hit sections* The first 

section controls hov/ many bits the Indicated field Is to 

be shifted left. The second section controls the number 
of hits to which the fleltf Is to he masked. If the 

specified format allows specification of three fields, 

the first Is specified by the rlrht twelve hits, the 
second by the middle twelve hits, and the third by the 

left twelve bits. If the format allows specification of 

only two fields, the first Is specified by the middle 
twelve bits, and the second by the left twelve bits* If 

the format allows specification of only one field. It is 

specified In the left twelve hits. Entries In the MIDAS 
format table may be chanred by the pseudo operation 

.FORMAT as follows: 

.FORMAT fn word 

where fn Is the number of the fornat as flven ir 

MAC-M-279 and word Is the new contents of that entry. 



Changes In operators: 

<up arrow) With no preceding argument has the value of the ASCII 
code for the character followlrtf masked to Its bottom 
six bits. 

! This character Is now deleted by the macro processor 

whenever It detects a dunmy varlahle If It was either of 
the del In 1 1 Inp break characters* 
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Changes ££ Q£X (supplementing memo DEC-6-0-UP-DDT-ur-FP-ACT00)- 
The following new commands have been Introduced: 

liV Aternate uses of this command turn on and off a display 

feature which has been added to DDT and which displays 
the current location and ten locations either side of 
It. 

\&* li< Takes a numeric arrument and treats It as five flrlds, 
the operation code, accumulator/ indirect bit. Index, 
and address. It has the value of l^fiwlth the nonzero 
fields In the argument substituted. 

n|JS Transfers locations kC to 177777 to the corresponrilnp 

locations In the n f "*th 200000 word block of memory. 

nil Transfers locations bO to 177777 In the n'th 200000 word 

block of memory to the corresponding locations In lower 
memory. 

n|£ Clears all of the n f th 200000 word block of memory to 

zero, 

I Afi 11 Sets the temporary output mode to AST 1 1 If n Is seven or 

SJXBIT If n it six. 
lilin" S3ts the permanent output mode In the same manner as 

I in" sets the temporary node. 
Ii u # li'i" Set the temporary and permanent output mode to ASCI I 

or SIXBIT depending on the most recent type specified. 

nliT # nliliT Set the temporary and permanent outout mode 

respectively to bytes of size n In the current radix, 

lin<close bracket> Takes a fol low In* string argument terminated 

by the first non-SIXBIT character and has the value of 

that string as SIXBIT or ASCII depending on whether n Is 

six or seven. 
l"*in<open bracket> Takes a following string argument whose first 

character Is used as the terminator and whose value Is 

determined as In |^in<close bracket^. 
li<close bracket), li<open bracket> Use the most recently set 
type of character string value. 

H<back slash> Has the value of the number that <hackslash> 
would rrint out except that Index Ing and Indirect 
addressing will he used. 
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The following •'commands 11 arr Ignored by the top level of DDT and 
will not terminate a search or multiple proceed: 

)£ Turns on line prlntlnp of ODT f s output, 

|£ Turns off ODT's line printer output (this Is the Initial 

state) . 

|\£ Turns on teletype output from DDT (this Is the Initial 

state). 

)W Turns off teletype output form DDT. 



Other changes: 

The " command will be affected by I In" and HI in" which may 
set It to either ASCII or SIXBIT, 

The n,,m format Is now recornl2ed by DDT on Input and may 
also be output In symbolic mode for numbers both halves of which 
are small negative numbers. 
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Appendix 

Loaders Normally Resident In the PDP-6 
; SHADOW MODE LOADER 

0/ JFCL 

1/ MOVSI (JFCL) 

2/ CONO 635550 

3/ CONO PI, 11577 

k/ CONO UTC, 223110 

5/ COKO DC, 1.010 

6/ COMSO DC, 1000 

7/ JRST 6 

10/ OATAI DC, 15 

11/ AOJGE 13,6 

12/ TRMF. 13,-1 

13/ 

11*/* JRST 6 

;RIM LOADER 



20/ CONO PTR,60 

21/ CONSO PTR.10 

22/ JRST 21 

23/ DATAI PTR,26 

2k/ COUSO PTR,10 

25/ JRST 2k 
26/ 

27/ JRST 21 



<-- ■ 



■■' 



